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© A method and system for aggregating objects within a computer system are provided. In a preferred 
embodiment, the method aggregates an enclosed object within an enclosing object. The enclosed object has an 
object management interface and an external interface, while the enclosing object has a controlling object 
management interface. Each interface exposed to a client by the aggregate object has a query function member 
for receiving an identifier of an interface and for returning a reference to the Identified interface. A preferred 
method creates an Instance of the enclosing object. The query function member of the controlling object 
management interface of the enclosing object receives an identifier of an interface exposed by the enclosing 
object and returns a reference to the exposed interface. A preferred method also creates an Instance of the 
enclosed object. The query function member of the external interface of the enclosed object receives an 
identifier of an interface, invokes the query function member of the controlling object management interface of 
the enclosing object passing the received identifier, and returns the reference returned by the invoked query 
function member of the controlling object management interface of the enclosing object as a reference to the 
identified interface. 
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Technical Reld 



This Invention relates generally to a computer method and system of implementing interfaces to objects 
and, more specifically, to a method and system for aggregating objects. 

Background of the Invention 



As computer software systems increase in sophistication, the cost of developing the software Increases 
To minimize the cost of software development, developers often share code. Prior development efforts use 
three types of code sharing: (1) source code sharing, (2) compiled code sharing, and (3) code sharino 
through Inheritance. 

Source and compiled code sharing have been widely used for many years. Source code sharing refers 
to the use of the same source code by various computer programs or by various versions of the same 
computer program. For example, a spreadsheet program typically includes source code to control the 
displaying of a, spreadsheet. If a word processing program allows the embedding of a spreadsheet within a 
document, then the word processing program may use the same (or slightly modified) source code to 
display the embedded spreadsheet object. Source code sharing is typically used by a single developer who 
develops multiple computer programs. For competitive reasons, developers typically do not share their 
source code with other developers. Moreover, even If the developer does share source code the recipient 
of source code typically modifies the source code and thus two versions of the source code are maintained 
Compiled code sharing refers to the use of the same compiled code by various computer programs 
The compiled code is typically stored in a static or dynamic link library. Compiled code stored in a static 
link library is shared when a computer program is linked before execution. Compiled code stored in a 
dynamic link library is shared when a computer program is linked during execution. The developer of a 
25 spell checking program, for example, may share compiled code by compiling the program and storing the 
compiled code In a static link library. The static link library can then be distributed to developers of word 
processing programs who can link the compiled spell checking code into their word processing program 
The developer of the spell checking program typically needs to modify the compiled code to meet special 
requirements of certain developers. These modifications tend to increase the complexity (and size) of the 
compiled code and may conflict with requirements of other recipients. Alternatively, the developer could 
distribute multiple versions of the static link library. However, the maintenance of multiple versions can be 
costly. 

Object-oriented programming techniques employ a concept referred to as inheritance to allow the 
sharing of code. To understand the concept of inheritance, it is helpful to understand object-oriented 
programming techniques generally. Two common characteristics of object-oriented programming languages 
are support for data encapsulation and data type inheritance. Data encapsulation refers to the binding of 
functions and data. Inheritance refers to the ability to declare a data type in terms of other data types 

In the C+ language, object-oriented techniques are supported through the use of classes A class is 
a user-defined type. A class declaration describes the data members and function members of the class 
For example, the following declaration defines data members and a function member of a class named 
CIRCLE. 



class CIRCLE 
{ public: 
inr X, y; 
int radius ; 
50 void draw ( ) ; 

}; 



55 



Vanables x and y specify the center location of a circle and variable radius specifies the radius of the circle 
These variables are referred to as data members of the class CIRCLE. The function draw is a user-defined 
function that draws the circle of the specified radius at the specified location. The function draw is referred 
to as a function member of class CIRCLE. The data members and function members of a class are bound 
together m that the function operates on an instance of the class. An instance of a class is also called an 
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object of the class. 

In the syntax of C+ -h. the following statement declares the objects a and b to be of type class 
CIRCLE. 

CIRCLE a, b; 

5 This declaration causes the allocation of nnemory for the objects a and b. The following statements assign 
data to the data members of objects a and b. 



a . y =2 

a. radius = 1 

b. x = 4 
b, y =5 
b . radius = 2 ; 
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The following statements are used to draw the circles defined by objects a and b. 

a, draw(); 

b. drawO; 

A derived class is a class that inherits the characteristics-data members and function members-of its 
base classes. For example, the following derived class CIRCLE_FILL inherits the characteristics of the 
25 base class CIRCLE. 



class CIRCLE_FILL : CIRCLE 
{ public: 

int pattern; 
void f ill () ; 

}; 



Th,s declaration specifies that class CIRCLE_FILL includes all the data and function members that are in 
class CIRCLE in addition to those data and function members introduced in the declaration of class 
CIRCLE__FILL. that is. data member pattern and function member fill. In this example, class CIRCLE FILL 
has data members x. y. radius, and pattern and function members draw and fill. Class CIRCLE FILL is said 

40 to inherit" the characteristics of class CIRCLE. A class that inherits the characteristics of anotTTer class is a 
denved- class (e.g.. CIRCLE_FILL). A class that does not inherit the characteristics of another class is a 
pnmary (root) class (e.g.. CIRCLE). A class whose characteristics are inherited by another class is a base 
class (e.g., CIRCLE is a base class of CIRCLE_FILL). A derived class may inherit the characteristics of 
several classes, that is. a derived class may have several base classes. This is referred to as multiple 

45 inhentance. 

A derived class may specify that a base class is to be inherited virtually. Virtual inheritance of a base 
class means that only one instance of the virtual base class exists in the derived class. For example the 
following IS an example of a derived class with two nonvirtual base classes. 



Class CIRCLE_1. : CIRCLE {...}; 
class CIRCLE_2 : CIRCLE {•..}; 
class PATTERN : . CIRCLE_1 , CIRCLE_2 {.•.}; 

In this declaration class PATTERN inherits class CIRCLE twice nonvirtually through classes CIRCLE 1 and 
CIRCLE_2. There are two instances of class CIRCLE in class PATTERN. ~ 
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The following is an example of a derived class with two virtual base classes. 

class CIRCLE_1 : virtual CIRCLE {.-.>; 
class CIRCLE_2 : virtual CIRCLE {.•.}; 
class PATTERN : CIRCLE_1 , CIRCLE_2 



The derived class PATTERN inherits class CIRCLE twice virtually through classes CIRCLE_1 and 
CIRCLE__2. Since the class CIRCLE is virtually inherited twice, there is only one object of class CIRCLE in 
the derived class PATTERN. One skilled in the art would appreciate virtual inheritance can be very useful 
when the class derivation is more complex. 

A class may also specify whether its function members are virtual. Declaring that a function member is 
virtual means that the function can be overridden by a function of the same name and type in a derived 
class. In the following example, the function draw is declared to be virtual in classes CIRCLE and 
CIRCLE FILL. 



20 class CIRCLE 

{ public: 
int X, y; 
int radius ; 

25 

virtual void draw(); 

}; 



class CIRCLE_FILL : CIRCLE 
{ public: 

int patterns- 
virtual void draw() ; 

}; 

The C + + language provides a pointer data type. A pointer holds values that are addresses of objects 
in memory. Through a pointer, an object can be referenced. The following statement declares variable 
c_ptr to be a pointer on an object of type class CIRCLE and sets variable c ptr to hold the address of 
object c. 



CIRCLE *c_ptr; 
c_ptr = &c; 



Continuing with the example, the following statement declares object a to be of type class CIRCLE and 
object b to be of type class CIRCLE_FILL. 
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CIRCLE a; 
CIRCLE_FILL b; 

5 

The following statement refers to the function draw as defined in class CIRCLE. 
a.drawQ; 

Whereas, the following statennent refers to the function draw defined in class CIRCLE_RLL. 
10 b.drawQ; 

Moreover, the following statenr^ents type cast object b to an object of type class CIRCLE and Invoke the 
function draw that is defined in class CIRCLE FILL. 
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CIRCLE *c_ptr; 
c_ptr = &b; 

c_p tr " > draw ( ) ; / / CIRCLE^FILL : : draw ( ) 



Thus, the virtual function that is called is function CIRCLE_FILL::draw. 

Figure 1 is a block diagrann illustrating typical data structures used to represent an object. An object is 
composed of instance data (data members) and member functions, which implement the behavior of the 
object. The data structures used to represent an object comprise instance data structure 101. virtual 

25 function table 102. and the function members 103. 104. 105. The instance data structure 101 contains a 
pointer to the virtual function table 102 and contains data members. The virtual function table 102 contains 
an entry for each virtual function member defined for the object. Each entry contains a reference to the 
code that implements the corresponding function member. The layout of this sample object conforms to the 
model defined in U.S. Patent Application Serial No. 07/682.537. entitled ''A Method for Implementing Virtual 

30 Functions and Virtual Bases in a Compiler for an Object Oriented Programming Language." which is hereby 
incorporated by reference. In the following, an object will be described as an instance of a class as defined 
by the C+ + programming language. One skilled in the art would appreciate that objects can be defined 
using other programming languages. 

The inheritance of a class is a type of code sharing. A developer of a class can provide the 

35 implementation of the class to other developers. These other developers can then create classes that derive 
from the class provided. Thus, the function members of the provided class are shared. If. however, a class 
is inherited and a virtual function is overridden, then the testing of the overriding virtual function can be 
complex. The overriding virtual function can modify the state of the object in a way that affects non- 
overridden functions. Thus, each inherited function must be independently tested' in conjunction with the 

40 testing of the overriding virtual function. To ameliorate the complexities of testing, the developers of a class 
implerhentation may distribute source code with the implementation. Unfortunately, the distribution of 
source code has the same drawbacks to sharing source code as discussed above. 

An advantage of using object-oriented techniques is that these techniques can be used to facilitate the 
sharing of objects. In particular, object-oriented techniques facilitate the creation of compound documents. A 

?5 compound document is a document that contains objects generated by various computer programs 
(Typically, only the data members of the object and the class type are stored in a compound document.) 
For example, a word processing document that contains a spreadsheet object generated by a spreadsheet 
program is a compound document. A word processing program allows a user to embed a spreadsheet 
object (e.g.. a cell) within a word processing document. To allow this embedding, the word processing 

■>o program is compiled using the class definition of the object to be embedded to access function members of 
the embedded object. Thus, the word processing program would need to be compiled using the class 
definition of each class of objects that can be embedded in a word processing document. To embed an 
object of a new class Into a word processing document, the word processing program would need to be 
recompiled with the new class definition. Thus, only objects of classes selected by the developer of the 

is .word processing program can be embedded. Furthermore, new classes can only be supported with a new 
release of the word processing program. 

To allow objects of an artaitrary class to be embedded into compound documents, interfaces are 
defined through which an object can be accessed without the need for the word processing program to 
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10 



have access to the class definitions at compile time. An abstract class is a class in which a virtual function 
member has no implementation (pure). An interface is an abstract class with no data members and whose 
virtual functions are all pure. 

The following class definition is an example definition of an interface. In this example, for simplicity of 
explanation, rather than allowing any class of object to be embedded in its documents, a word processing 
program allows spreadsheet objects to be embedded. Any spreadsheet object that provides this interface 
can be embedded, regardless of how the object is implemented. Moreover, any spreadsheet object 
whether implemented before or after the word processing program is compiled, can be embedded 



class ISpreadSheet 

{ virtual void File() = 0; 
virtual void Edit() = 0; 
virtual void Formula() = 0; 
virtual void Format() = 0; 

vinual void GetCell (string RC, cell 'pCell) = 0; 
20 virtual void Data() = 0; 

} 



The developer of a spreadsheet program would need to provide an Implementation of the interface to allow 

25 the spreadsheet objects to be embedded in a word processing document. When the word processing 
program embeds a spreadsheet object, the program needs access to the code that implements the 
rnterface for the spreadsheet object. To access the code, each implementation is given a unique class 
Identifier. For example, a spreadsheet object developed by Microsoft Corporation may have a class 
Identifier of "MSSpreadsheet," while a spreadsheet object developed by another corporation may have a 

30 class identifier of "LTSSpreadsheet." A persistent registry in each computer system is maintained that 
maps each class identifier to the code that implements the class. Typically, when a spreadsheet program is 
installed on a computer system, the persistent registry is updated to reflect the availability of that class of 
spreadsheet objects. So long as a spreadsheet developer implements each function member defined by the 
interface and the persistent registry is maintained, the word processing program can embed the developer's 

35 spreadsheet objects into a word processing document. 

Various spreadsheet developers may wish, however, to implement only certain function members For 
example, a spreadsheet developer may not want to implement database support, but may want to support 
all other function members. To allow a spreadsheet developer to support only some of the function 
members, while still allowing the objects to be embedded, multiple interfaces for spreadsheet objects are 

40 defined. For example, the Interfaces IDatabase and IBasic may be defined for a spreadsheet object as 
follows. 



45 



50 



55 



6 



10 



15 



20 



30 



35 



EP 0 603 880 A2 

class IBasic 

{ virtual void File() = 0; 
virtual void Edit() = 0; 
virtual void Formula() = 0; 
virtual void Format() = 0; 

vinual void GetCell (siring RC cell "pCell) = 0; 

} 

class IDatabase 

{ virtual void Data() = 0; 

} 



Each spreadsheet developer would implement the IBasic interface and. optionally, the IDatabase interface 

At run time, the word processing program would need to determine-whether a spreadsheet object to be 
embedded supports the IDatabase interface. To make this determination, another interface is defined (that 
every spreadsheet object implements) with a function member that indicates which interlaces are imple- 
mented for the object. This interface is named lUnknown (and referred to as the unknown interface or the 
25 Object management interface) and is defined as follows. 

class lUnknown 

{ vinual boolean Querylnterface (REFIID iid, void '"ppv) = 0; 
virtual void AddRef() = 0; 
virtual void Release () = 0; 

} 



40 



The lUnknown mterface defines the function member (method) Querylnterface. The method Querylnterface 
IS passed an interface identifier (e.g.. "IDatabase") in parameter iid (of type REFIID) and returns a pointer to 
the implementation of the identified interface for the object for which the method Fs invoked in parameter 
ppv. If the object does not support the interface, then the method returns a false. 
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CODE TABLE \ 

booleaiiXX::Quen^Interface(REFIID iid, void """ppv) 
{ ret = TRUE; 
switch (iid) 
{ case IID_IBasic: 

"ppv = ''pIBasic; 

break; 
case IID_IDatabase: 

''ppv = *pIDatabase; 

break; 
case IID_IUnknown: 

°ppv = this; 

break; 
default: 

ret = FALSE; 



if (ret == TRUE){AddRef();}; 
return ret; 

} 



Code Table 1 contains C+ + source code for a typical implementation of the method Querylnterface for 
class XX. which inherits the class (Unknown. If the spreadsheet object supports the {Database interface, 
30 then the method Querylnterface includes the approphate case label within the switch statement. The 
variables pIBasic and pIDatabase point to a pointer to the virtual function tables of the IBasic and IDatabase 
interfaces, respectively. The method Querylnterface invokes to method AddRef (described below) to 
increment a reference count for the object of class XX when a pointer to an interface is returned. 

35 CODE TABLE 2 

void XX::AddRefO{refcount+ + ;} 

void XX::Release(){if(-refcount = = 0) delete this;} 

40 The interface lUnknown also defines the methods AddRef and Release, which are used to implement 
reference counting. Whenever a new reference to an interface is created, the method AddRef is invoked to 
increment a reference count of the object. Whenever a reference is no longer needed, the method Release 
is invoked to decrement the reference count of the object and, when the reference count goes to zero, to 
deallocate the object. Code Table 2 'contains C++ source code for a typical implementation of the 

45 methods AddRef and Release for class XX, which inherits the class lUnknown. 

The IDatabase Interface and IBasic interface .inherit the lUnknown interface. The following definitions 
illustrate the use of the lUnknown interface. 



50 



55 



8 



EP 0 603 880 A2 



class IDatabase : public lUnknown 
{ public: 
virtual void Data() = 0; 

} 

class IBasic : public lUnknown 
{ public: 
vinual void File() = 0; 
virtual void Edit() = 0; 
virtual void Formula() = 0; 
virtual void Format() = 0; . 
vinual void GeiCell (siring RC, cell *pCell) = 0; 

} 

Figure 2 is a block diagram illustrating a sample data structure of a spreadsheet object. The 
spreadsheet object comprises object data structure 201. IBasic interface data structure 202. IDatabase 
interface data structure 204. the virtual function tables 202. 205. 206 and methods 207 through 221. The 
object data structure 201 contains a pointer to the virtual function table 202 and pointers to the IBasic and 
IDatabase interface. Each entry in the virtual function table 202 contains a pointer to a method of the 
lUnknown interface. The IBasic interface data structure 203 contains a pointer to the virtual function table 
205. Each entry in the virtual function table 205 contains a pointer to a method of the IBasic interface. The 
IDatabase interface data structure 204 contains a pointer to the virtual function table 206. Each entry in the 
virtual function table 207 contains a pointer to a method of the IDatabase interface. Since the IBasic and 
IDatabase interfaces inherit the lUnknown interface, each virtual function table 205 and 206 contains a 
pointer to the methods Querylnterface, AddRef. and Release. In the following, an object data structure is 
represented by the shape 222 labelled with the interfaces through which the object may be accessed. 

The following pseudocode illustrates how a word processing program determines whether a spread- 
sheet object supports the IDatabase interface. 



if (pIBasic->QueryInterface(*'IDatabase", &plDatabase)) 

\" IDatabase supported 

else 

\' IDatabase not supported 



The pointer pIBasic is a pointer to the IBasic interface of the object. If the object supports the IDatabase 
interface, the method Querylnterface sets the pointer pIDatabase to point to the IDatabase data structure 
and returns true as its value. 

Normally, an object can be instantiated (an instance of the object created in memory) by a variable 
declaration or by the "new" operator. However, both techniques of instantiation need the class definition at 
compile time. A different technique is needed to allow a word processing program to instantiate a 
spreadsheet object at run time. One technique provides a global function CreatelnstanceXX. which is 
defined in the following. 

static void CreatelnstanceXX (REFIID iid, void "ppv) = 0; 
The method CreatelnstanceXX instantiates an object of class XX and returns a pointer ppv to the interface 
of the object designated by parameter iid. 



EP 0 603 880 A2 



15 



20 



Summary of the Invention 

It is an goal of the present invention to provide a method and system for aggregating objects. 
It is another goal of the present invention to provide a method and system for enclosing an object within 
5 another object while exposing an interface of the enclosed object to a client of the enclosing object. 

It is another goal of the present invention to provide a method and system for implementing an object 
that can be either enclosed within another object or not enclosed within another object without modifying 
the implementation of the object. 

It is another goal of the present invention to provide a method and system for implementing an 
70 aggregate object so that a client is unaware that the object Is an aggregate. 

It is another goal of the present invention to provide a method and system for enclosing objects wherein 
the enclosed objects can itself be an enclosing object to an arbitrary level of enclosing. 

These and other goals, which will become apparent as the invention is more fully described below, are 
provided by a method and system for aggregating objects within a computer system. In a preferred 
embodiment,. the method aggregates an enclosed object within an enclosing object. The enclosed object 
has an object management interface and one or more external Interfaces, while the enclosing object has a 
controlling object management interface. Each interface exposed to a client by the aggregate object has a 
query function member for receiving an identifier of an interface and for returning a reference to the 
identified interface. The query function member of the controlling object management interface of the 
enclosing object receives an identifier of an Interface exposed by the enclosing object and returns a 
reference to the exposed interface. A preferred method creates an instance, of the enclosed object. The 
query function member of an exposed interface of the enclosed object receives an identifier of an interface 
invokes the query function member of the controlling object management interface of the enclosing object 
passrng the received identifier, and returns the reference returned by the invoked query function member of 
25 the controlling object management interface of the enclosing object as a reference to the identified 
interface. 

In a preferred embodiment, the query function members of an enclosed object are implemented with 
knowledge of the external Interfaces of the enclosed object and have no knowledge of interfaces (other than 
the controlling object management interface) of the enclosing object or other enclosed objects. 

Brief Description of the Drawings 

Figure 1 is a block diagram illustrating typical data structures used to represent an object. 
Figure 2 is a block diagram illustrating a sample data structure of a spreadsheet object. 
Figure 3 is a block diagram showing an aggregate object. 

Figure 4 Is a block diagram of the data structure layout of an instance of an object of class 02. 
Figure 5 is a block diagram of the data structure layout of an object of class 01 . 

Figures 6A and 6B are block diagrams illustrating the cooperation between an enclosing object and an 
enclosed object. 

Detailed Description of the Invention 

The present invention provides a method in a computer system for aggregating objects. In a preferred 
embodiment, an aggregate object provides a plurality of interfaces to its clients. The computer program that 
instantiates an object is referred to as a client. An aggregate object comprises one or more enclosed 
objects and an implementation of the lUnknown interface, which is referred to as the controlling lUnknown 
mterface of the aggregate object. An aggregate object exposes to its clients its own interfaces and 
interfaces from the enclosed objects. The method Querylnterface of the controlling lUnknown interface 
returns a pointer to each interface exposed by the aggregate object. The aggregate object instantiates each 
enclosed object. This instantiation can be performed during construction of the aggregate object or can be 
postponed until an interface of the enclosed object is requested. Each enclosed object contains a pointer to 
the controlling lUnknown interface. The method Querylnterface of an exposed interface of an enclosed 
object IS preferably implemented to invoke the method Querylnterface of an lUnknown interface When the 
enclosed object is implemented, the developer typically has no knowledge of what interfaces the enclosing 
object may expose. Consequently, the method Querylnterface of an enclosed object invokes the method 
Querylnterface of the controlling lUnknown interface to retrieve a pointer to the requested interface. The 
method Querylnterface of the controlling lUnknown interface is typically implemented with knowledge of all 
the exposed interfaces. When an object is not enclosed, the controlling lUnknown interface is the lUnknown 
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interface of the object. Conversely, when an object is enclosed, the controlling lUnknown interface is the 
lUnknown interface of the enclosing object. 

In a preferred embodiment, an aggregate object maintains a reference count. When the aggregate 
object Is instantiated, its reference count is set to one. The method Query Interface of the controlling 
5 lUnknown increments the reference count when a reference is returned to the client. The method AddRef of 
an exposed interface of an enclosed object invokes the method AddRef of the controlling lUnknown 
interface to increment the reference count of the aggregate object. Similarly, the method Release of an 
exposed interface of an enclosed object invokes the method Release of the controlling lUnknown interface 
to decrement the reference count of the aggregate object and delete the aggregate object when the 

70 reference count equals zero. When an enclosed object is instantiated, the reference count of the enclosed 
object is set to one. When the aggregate object is deleted, the method Release of the lUnknown interface of 
each enclosed object is invoked to delete the enclosed object. 

In a preferred embodiment, the methods and systems of the present invention are implemented on a 
computer system comprising a central processing unit, memory and input/'output devices. 

75 Figure 3 is a block diagram showing an aggregate object. The aggregate object S3 exposes interfaces 
A. B, C. F. and the controlling lUnknown. The aggregate (enclosing) object S3 comprises enclosed object 
S1 303. enclosed object S2 302. and implementation 13 304. The enclosed object S1 implements external 
interfaces C and D. and the enclosed object S2 implements external interfaces E and F. (An externa! 
interface is an interface of an object that can be exposed by an enclosing object. An internal interface is an 

20 interface of an object that cannot be exposed by an enclosing object.) The implementation 13 implements 
external interfaces A. B. and the controlling lUnknowh. A client of the aggregate object S3 need not be 
aware that the object is an aggregate. The aggregate object S3 instantiates objects SI and S2 either during 
construction of aggregate object S3 or at a later time. The implementation 13 contains pointers to the 
lUnknown interfaces of objects Si and S2. Objects SI and S2 are initialized to contain a pointer to the 

25 controlling lUnknown interface. 

The method Query Interface of an exposed interface can return a pointer to each exposed interface and 
increments the reference count of the aggregate object when a pointer is returned. The method Querylnter- 
face of the controlling lUnknown has direct access to the pointers to the interfaces-- A. B. and controlling 
lUnknown -that implementation 13 implements and invokes the method Querylnterface of the lUnknown 

30 interface of the enclosed objects to retrieve pointers to the exposed interfaces - C and F -of enclosed 
objects SI and S2. When a pointer to an exposed interface is returned, the method Querylnterface of the 
controlling lUnknown interface increments the reference count of the aggregate object S3 by invoking the 
method AddRef of the controlling lUnknown interface. The method Querylnterface of each exposed interface 
(other than the controlling lUnknown interface) preferably invokes the method Querylnterface of the 

35 controlling lUnknown interface. 
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CODE TABLE 3 

void CreatcInstanccSl (lUnknown *punkOutcr, REFIID iid, void **ppv) 
{ lUnknown *punk; 

Sl::CreateInstance (punkOuter, &punk); 

punk->QueryInlcrfacc (iid, ppv); 

punk- > Release (); 

} 

class IC: public lUnknown 
{ // methods of IC} 

class ID: public lUnknown 
{ // methods of ID} 

class SI: public lUnknown 

{ 

public: 

static void CreateInsiance(IUnknown *punkOutcr, lUnknown ••ppunk) 
{ SI 'pSl = new Sl(punkOutcr); 

pSl->OucrvInicrrace(IID_IUnknown, ppunk); 

} 

private: 

void Sl(IUnknown *punkOutcr) : m C(lhis), m_D(ihis) 
{ if (punkOuter = = NULL) " 

ni_punkOutcr = this: 

else 

m^punkOuter = punkOuter, 
ni_rercount - 0; 

} 

class C: public IC 

{ 

public: 

C(S1 -pSl) {m_pSl = pSl;} 

virtual boolean Qucrylnierface (REFIID iid, void **ppv) 

{ return m_pSl-> m_punkOutcr-> Query Inierface{iid, ppv);} 

virtual void AddRef() 

{ m_pSl->m_punkOulcr->AddRefO;} 
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virtual void Rdcasc() 

{ in_pSl->m_punkOutcr-> RclcascQ;} 

// other methods of IC 

private: 

SI •mjjSl; 

friend C; 

C mjC; 

class D: public ID 
{ 

public 

D(S1 -pSl) {m_pSl = pSl;} 

virtual boolean Qucrylntcrfacc (REFIID tid, void '^ppv) 

{ return in_pSl-> m^pu nk Outer- > Que rylntcrfacc(ild, ppv);} 

virtual void AdURcfO 

{ in_pSl->in_punkOuter-> AddRcrO;} 

virtual void RelcaseQ 

{ m_pSl->m_punkOuter->ReIeaseO;} 

// other methods of ID 

private: 

SI •mj>Sl; 

} 

friend D; 

D m_D; 



virtual boolean Oucrylnicrfacc (REFIID iid, void **ppv) 
{ ret - TRUE; 

switch (iid) 
{ case IID_C: 

•ppv K &m_C; 
m_punkOutcr- > AddRcfO; 
break; 
case HD D: 

*ppv = ,S:m_D; 
m_punkOuicr- > AddRclO; 
break; 
case II D^I Unknown: 
•ppv » this; 
AddRefQ; 
break; 

default: 

ret « FALSE; 

} 

return ret; 

} 
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virtual void AddRef(){ m_refcount +-*-;} 

virtual void RcleascQ {if (--m_rcfcount = = 0) delete this;} 



private: 

lUnknown "m punkOuter; 

int m rcfcount; 

) 

Code Table 3 contains a C + + class definition of the object S1. which can be enclosed In an aggregate 
(an aggregatable object) along with a global function that creates an instance of the object The classes 
lUnknown. IC, and ID are interfaces that define the methods of each interface. The class Si implements the 
lUnknown interface, the IC interface, and the ID interface. The class Si implements the IC and ID interfaces 
as external interfaces. Figure 4 is a block diagram of the data structure layout of an instance of an object of 
class 81. Instance structure 401 contains the data members of class Si (m_C. m_D, m punkOuter 
m_refcount) and a pointer the virtual function table pointer (SI ::vfptr). The data members m C and m D 
are instances of an object of classes C and D. respectively. Classes C and D are friends of class S1. whi^h 
allows C and D objects to access the private members of class SI. The virtual function table pointer 
S1::vfptr points to virtual function table 402. the virtual function table pointer within data member m C 
Sl::C::vfptr points to virtual function table 403, and the virtual function table pointer within data memb"er 
m_D Sl::D::vfptr points to virtual function table 403A. Virtual function table 402 contains pointers to the 
virtual functions defined for the lUnknown interface, virtual function table 403 contains pointer to the virtual 
functions defined for the C interface, and virtual function table 403A contains pointers to the virtual function 
25 defined for D interface. The ellipsis in virtual function tables 403 and 403A indicates pointers to additional 
function members of classes C and D. respectively. Functions 404 through 408 are the function members of 
class 81. Function 407 is the constructor for class 81. Function 408 is the function Createlnstance for class 
81. Functions 409 through 412 are the function members of class C. Function 412 is the constructor for 
class C. Functions 413 through 416 are the function members of class D. Function 416 is the constructor for 
30 class D. 

As shown in Code Table 3. the method Si ::Query Interface returns a pointer to the interface C the 
interface D. or the interface lUnknown and invokes the method S1::AddRef to increment the reference count 
for the SI object. The method S1::AddRef increments the reference count, and the method Si - Release 
decrements the reference count and deletes the Si object when the reference count is zero. 

The global function CreatelnstanceSi creates an instance of an object of class Si . A client invokes this 
function to instantiate an object of class 81. Thus, a client can instantiate an object of class 81 without 
having access to the Si class definition at compile time or run time. The function CreatelnstanceSi is 
passed a pointer to the controlling lUnknown (punkOuter) when the instantiated Si object is enclosed within 
an aggregate object and an identifier (lid) of an interface to return. The function CreatelnstanceSi returns a 
40 pointer (ppv) to the identified interface. The function CreatelnstanceSi invokes the method 
SI -Createlnstance passing the parameter punkOuter. The method Si. "Createlnstance instantiates an 81 
object and returns a pointer (punk) to the lUnknown interface of the 81 object. The function Createlnstan- 
ceSi invokes the method Querylnterface of the SI object to retrieve a pointer to the identified interface 
The function CreatelnstanceSi then invokes the method Release of the 81 object because the temporary 
45 pointer punk is no longer needed. 

The method S1::Createlnstance instantiates an 81 object and returns a pointer (ppunk) to the lUnknown 
interface of the SI object. The method Si ."Createlnstance is passed a pointer (punkOuter) to the controlling 
lUnknown. The method Sl::Createlnstance uses operator new to instantiate the 81 object. During instan- 
tiation, the constructor 8l::8l is invoked and passed the value of the parameter punkOuter After the 81 
50 object IS constructed, the method Si "Createlnstance invokes the method S1::Querylnterface to retrieve a 
pointer to the lUnknown interface of the 81 object. 

The constructor S1::S1 initializes the data members m_C. m_D. m_punkOuter. and m refcount The 
constructor S1::S1 is passed the parameter punkOuter. During instantiation of the data members m C and 
m_D. the constructors C::C and D::D are Invoked and passed the this pointer for the Si object If th^ value 
of the parameter punkOuter is NULL, the constructor Sl::Sl sets the data member m_punkOuter to the 
value of the this pointer (which points to the newly instantiated 81 object). If the value of the parameter 
punkOuter is non-NULL. the constructor S1::S1 sets the data member m_punkOuter to the value of 
parameter punkOuter. Data member m_punkOuter points to the value of the controlling lUnknown of the 
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aggregate when the Si object is enclosed and points to the controlling lUnknown of the Si object when the 
S1 object IS not enclosed. The constructor Sl::Sl also initializes the data member m_refcount to zero 

The constructor C::C is passed a pointer to the Si object. The constructor C::C stores the passed 
pointer in data member C::m_pS1. The data member C::m_pSl is used by the methods of class C to 
access the data member Sl;:m_punkOuter. 

The methods C::Query Interface. C::AddRef. and C::Release invoke the corresponding methods of the 
lUnknown interface pointed to by data member Sl::m_punkOuter. which when the Si object is enclosed 
points to the controlling lUnknown interface of the aggregate. 

The constructor and other methods of class D are analogous to those of class C. 

Figure 4 shows an instance of an Si object that is not part of an aggregate. The data members 
S1::C::m_pSl. Si ::D::m_pSl . and 81 ::m_punkOuter are initialized to pointer to the S1 object itself The 
methods Querylnterface. AddRef. and Release of the data members m_C and m D invoke the lUnknown 
methods of the interface of the Si object. 

The S2 object that implements interfaces E and F is analogous to the Si object as described above. 



CODE TABLE 4 

void CrcatcInstanccS3 (lUnknown •punkOutcr, REFIID iid, void '^ppv) 
{ lUnknown *punk; 

S3::CrcatcInstancc (punkOutcr, *S:punk); 

punk- > Query Interface (ild, ppv); 

punk- > Release Q; 

} 

class lA: public lUnknown 
{ // mctiiods of dass lA} 

class IB: public lUnknown 
{ // mctiiods of class IB } 

class S3: public lUnknown 

{ 

public 

static void Create Instancc( I Unknown •punkOutcr, lUnknown ••ppunk) 
{ S3 "pS3 « ncwS3(punkOuicr); 

CrcatcInstanccSl(pS3->mj5unkOulcr, IID^IUnknown, pS3->mj)uiikSl); 

Crcaic!nsianccS2(pS3->m_punkOutcr, HDJUnknown, pS3->m_punkS2); 

pS3->0ucryIntcrfacc(iid, ppv);} 

private: 

void S3(IUnknown •punkOutcr) : m A(lhis), m_B{lhis) 
{ if (punkOutcr NULL) 

m^punkOutcr = this; 

cisc 

m^punkOulcr = punkOuter. 
m_rcfcount = 0;} — 

.void*S3() {m_punkSI->RcIcasc(); 

ni_punkS2->RcicascO;) 

class A: public lA 

{ 
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public: 

void A(S3 •pSS) {m_pS3 = pS3} 

virtual boolean Oucrylnicrfacc (REFIID iid, void "ppv) 
{ rclurn m_pS3-> mj)unkO uter-> Query Interface (iid, ppv);} 

virtual void AddRcf() 

{ m_pS3->m_punkOutcr->AddRcfO;} 

virtual void RcIcascQ 

{ in_pS3->m_punkOutcr-> RcIcascQ;} 



\\ other mclhods of lA 

75 private: 

S3 *m pS3; 

}; 

friend A; 

A m A; 



class B: public IB 

{ 

public: 

void B(S3 •pS3) {m_pS3 = pS3} 

virtual boolean Oucrylnicrfacc (REFIID iid, void •*ppv) 

{ return m_pS3->m_punkOutcr->Oucrylnlcrfacc(iid, ppv);} 



virtual void AddRcf() 

{ m_pS3->m_punkOutcr->AddRcrO;} 

30 virtual void Rclcasc() 

{ m_pS3->mj>unkOutcr-> RcIcascQ;} 

\\ other mclhods of IB 

private: 



40 public 



S3 *m_pS3; 

}; 

friend B; 

B m B; 



virtual boolean OucryInicrfacc{REFIID iid, void *'ppv) 
{ ret - TRUE; 

switch (iid) 
{ case IID^C 

ret = m^punkS I- > Query Interface (iid, ppv); 
break; 
cascIID_F: 

ret = m_punkS2->0ucrylnlcrfacc(iid, ppv); 
break; 
casclip^A: 

•ppv - &m_A; 
m_punkOuicr- > AddRcfQ; 
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break; 
case IID_B: 

•ppv = &m_B; 

m^punkOutcr- > AddRcfQ; 

break; 
case IID_IUnknown: 

•ppv = this; 

AddRcfQ; 
break; 

default: 

ret = FALSE; 

} 

return ret; 

} 

virtual void AddRefQ { rn_rcfcount+ +;} 

virtuaJ void RclcascO {if ("tn^rcfcouni = = 0) dcicic this;} 

private: 

lUnknown *m_punkOuier; 
int m^rcfcouni; 
lUnknown *ni_punkS 1 ; 
lUnknown •m_punkS2; 

}; 



Code Table 4 is a C + + class definition of an aggregate object. The class S3 exposes the interfaces 

30 lUnknown. A, B, C. and F. To provide the C interface, the class S3 encloses an Si object and exposes the 
C interface. To provide the F interface, the class S3 encloses an S2 object and exposes the F interface. 
The S3 object exposes the C and F interfaces by returning pointers to the C and F interfaces through the 
method Querylnterface of the controlling lUnknown interface. The D interface of the 81 object and the E 
interface of the S2 object are external interfaces, but the S3 object does not expose these interfaces. 

35 The nnethods S3::Querylnterface. S3::AddRef, and S3::ReIease compose the controlling lUnknown 
interface for the aggregate. The method S3:: Querylnterface returns a pointer to the controlling lUnknown. A. 
■ ' B. C. or F Interfaces and increments the reference count for the S3 object. The method S3::AddRef 
increments the reference count, and the method S3::Release decrements the reference count and deletes 
the S3 object when the reference count is zero. 

40 The global function Create Instance S3 creates an instance of an object of- class S3. A client invokes this 
function to instantiate an object of class S3. Thus, a client can instantiate an object of class S3 without 
having access to the S3 class definition at compile time or run time. The function Createlnstance S3 is 
passed a pointer to the controlling lUnknown interface (punkOuter) when the instantiated S3 object is 
enclosed within an aggregate object and an Identifier (iid) of an interface exposed by the class S3 to return. 

45 The function CreatelnstanceS3 returns a pointer (ppv) to the identified Interface. The function Createlnstan- 
ceS3 invokes the method S3::CreateInstance passing the parameter punkOuter. The method 
S3::Createlnstance instantiates an S3 object and returns a pointer (punk) to the lUnknown interface of the 
S3 object. The function CreatelnstanceS3 then Invokes the method S3:: Query Interface to retrieve a pointer 
to the identified interface. The function Create In stance S3 then invokes the method S3::Release because the 

50 temporary pointer punk is no longer needed. 

The method S3:: Create Instance instantiates an S3 object and returns a pointer (ppunk) to the lUnknown 
interface of the S3 object. The method S3::Createlnstance is passed a pointer (punkOuter) to the controlling 
lUnknown. The method S3::Createlnstance uses operator new to instantiate the S3 object. During instan- 
tiation, the constructor S3::S3 is invoked and passed the value of the parameter punkOuter. After the S3 

55 object is constructed, the method S3::Createlnstance invokes the function CreatelnstanceSi to create the 
enclosed Si object. The method S3::Createlnstance passes the parameter m__po1-> punkOuter and the 
interface identifier for the lUnknown interface and is returned a pointer to the lUnknown interface of the Si 
object. The method S3::Createlnstance stores the returned pointer in data member S3:;m_punkSl. The ' 
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method S3:: Create Instance then invokes the function CreatelnstanceS2 to create an S2 object in a manner 
analogous to the creation of the Si object. The method S3::Createlnstance invokes the method 
S3::Querylnterface to retrieve a pointer to the interface identified by the parameter iid. 

The method S3::AddRef increments the reference count of the S3 object. The method S3;:Release 
decrements the reference count. When the reference counts is zero, the method S3::Release deletes the S3 
object. 

The constructor S3::S3 initializes the data members m_A. m__B, m_punkOuter, and m_refcount. The 
constructor S3::S3 is passed the parameter punkOuter. During instantiation of the data members m_A and 
m_B. the constructors A::A and B::B are invoked and passed the tMs pointer for the S3 object. If the value 
of the parameter punkOuter is NULL, the constructor S3::S3 sets the data member m_punkOuter to the 
value of the this pointer (which points to the newly instantiated S3 object). If the value of the parameter 
punkOuter is non-NULL, the constructor S3::S3 sets the data member m_punkOuter to the value of 
parameter punkOuter. Data member m_punkOuter points to the value of the controlling lUnknown interface 
of the aggregate when the S3 object is enclosed and points to the lUnknown interface of the S3 object 
when the S3 object is not enclosed. The constructor S3::S3 initializes the data member m_refcount to zero. 

The destructor S3::~S3 invokes the method Sl::ReIease to decrement the reference count of the 
enclosed Si object. Since the reference count was set to one during instantiation of the Si object the 
method Sl::Release deletes the SI object. The destructor S3::-S3 decrements the reference count of the 
S2 object in an analogous manner. 

The methods of the A and B interfaces have an analogous behavior to the methods of the C interface. 
Thus, the A and B interface can be exposed when an S3 object is enclosed. 

Figure 5 is a block diagram showing the data structure layout of an S3 object. The'data structure layout 
compnses instance data 501. virtual function tables 502. 503, and 504. methods 505 through 517 and 
instances of an SI object 401-416 and an S2 object 519. The instance data 501 contains a pointer to the 
virtual function table for the controlling lUnknown interface, data members m_A and m___B which are 
instances of class A and B. data member m_punkOuter which points to the lUnknown interface of the S3 
object, data member m_refcount which contains the reference count for the S3 object, data member 
m__punkS1 which points to the lUnknown interface of the enclosed Si object, and data member 
m__punkS2 which points to the lUnknown interface of the enclosed S2 object 519. When the enclosed SI 
object is instantiated, its data member Sl::m_punkOuter is initialized to point to the lUnknown interface of 
the S3 object. Similarly, when the enclosed S2 object is instantiated, its data member S2::m punkOuter is 
initialized to point to the lUnknown interface of the S3 object ~~ 

Figures 6A and 6B are block diagrams illustrating the cooperation between an enclosing object and an 
enclosed object. Figure 6A is a block diagram illustrating an object of class Si that is not enclosed within 
another object. The class Si object 601 includes data member m_punkOuter. which points to the 
lUnknown interface and methods 603. 604. 605. and 606. The method IUnknown::Querylnterface 603 returns 
a pointer to the requested interface and increments the reference count. The methods C::Querylnterface 
605 and C::AddRef 606 invoke the corresponding methods of the lUnknown interface. The implementation 
of the methods of class D (not shown) are analogous to those of class C. Figure 6B is a block diagram 
Illustrating an object of class S3 that encloses objects of class Si and S2. The S2 object, which is 
analogous to the Si object, is not shown. The data member m_punkOuter 602 of the class Si object 601 
points to the lUnknown interface of the class S3 object 610. The method IUnknown::Querylnterface 613 
returns a pointer to each of the exposed objects and invokes the method I Unknown:: Query Interface 603 
pointed to by data member m_punkSl 619 to retrieve a pointer to the C interface. The data member 
m_punkOuter 612 points to the lUnknown Interface of the class S3 object 610. The methods Querylnter- 
face 615 and 617 of the class A and B objects invoke the methods pointed to by data member 
m punkOuter 612. - - - - — - - 

In the above-described embodiment of the present invention, the method Query Interface of the 
controlling lUnknown interface of an aggregate invokes the method Querylnterface of the lUnknown 
interface of enclosed objects to retrieve pointers to the exposed interfaces. In an altemate embodiment of 
the present invention, an enclosing object can cache pointers to interfaces of enclosed objects that the 
enclosing object exposes. Thus, when the method Querylnterface of the controlling lUnknown is invoked 
the method can retrieve and return the cached pointers, rather than invoke the method Querylnterface of 
the lUnknown interface of the enclosed object. To implement this altemate embodiment, an enclosing object 
defines a data member for each cached pointer. When the enclosed object is Instantiated (typically during 
construction of the enclosing object), the method Querylnterface of the lUnknown interface of the enclosed 
object IS invoked to retrieve a pointer of the exposed interface. It is preferred that the retrieved pointer is not 
reference counted so that the enclosing object effectively mantatns only one pointer (e.g.. S3::m__punkSl ) 
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to an enclosed object. The enclosed object can then be deleted by a single call to the method Release. 
Therefore, after the pointer is cached, the nnethod Release of the lUnknown interface of the enclosed object 
is invoked to remove the reference count attributable to the cached pointer. 

In the above-described embodiment of the present invention, the implementation of the method 
Querylnterface of the controlling lUnknown interface includes a switch statement that specifies which 
interfaces are exposed. For example, the switch statement of the method S3::Querylnterface includes a 
case label for each exposed interface A. B. C, F. and the controlling lUnknown. Thus, the exposed 
interfaces are statically defined during implementation of the enclosing object. In an alternate embodiment, 
the method Querylnterface of the controlling lUnknown interface can be implemented without specific 
knowledge of the external interfaces of the enclosed objects. When the method Querylnterface is requested 
to return a pointer to an interface that it does not implement, the method can invoke the method 
Querylnterface of the lUnknown interfaces of the enclosed objects to retrieve a pointer to the identified 
interface, if implemented by an enclosed object. Code Table 5 is a C + + implementation of the method 
Querylnterface of the controlling lUnknown of a S3 object that implements this alternate embodiment. In 
addition to returning a pointer to each external interface of the enclosed objects, the method Querylnterface 
of the controlling lUnknown could be implemented to not expose certain external interfaces, while exposing 
all other external interfaces. 



CODE TABLE 5 

virtual boolean Oucrylnicrfacc (REFIID iid, void **ppv) 
{ ret « TRUE; 
switch (iid) 
{ case IID_A: 

•ppv « &m_A; 

m_punkOuicr->AddRef(); 

break; 
case IID_B: 

•ppv » &.m_B; 



m_punkOutcr->AddRef(); 
break; 
ca^e IID lUnknown: 
*ppv = this; 
AddRefO; 
break; 

default: 

if (m_punkSl-> Querylnterface (iid, ppv)) { return, ret;}; 
if (mj5unkS2-> Querylnterface (iid, ppv)) { return ret;); 
ret = FALSE; 

} 

return ret; 
} 



In the above-described embodiments, error checking has not been described. It is preferred that various 
types of error checking are performed to. ensure that an aggregate is properly created. For example, if an 
enclosing object tries to enclose an object that is not aggregatable. then the instantiation of the enclosing 
object should fail (e.g.. the function C reate In stances 1 returns a flag indicating failure). 

In the above-described embodiments, an aggregate object can itself be an enclosed object within an 
enclosing object. This enclosing (nesting) can occur to any depth. Alternately, an aggregate object can be 
implemented to be non-aggregable. The function CreatelnstanceXX for the class XX can return a flag 
indicating a failure when the parameter punkOuter is non-null, that is. when aggregation is desired. 
In the above-described embodiment, an object for each external interface of an aggregable object is 
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instantiated as a data member of the aggregatee object. In an alternate embodiment, the external interfaces 
are inherited by the aggregabie object, rather than implemented as data members of the aggregable object. 
Code Table 6 contains a C + + class definition Si of an aggregable class with external interfaces C and D. 
The class S1 inherits the abstract classes IC and ID. The implementations of the IC and ID interfaces need 
not store a pointer to the derived class Si to access the data member m_punkOuter. Conversely, the 
implementions of the IC and ID interfaces, as shown in Code Table 3. store the pointer to the' derived class 
31 in the data member m_pSl. One skilled in the art would appreciated that other implementations using 
inheritance of interfaces are possible. 



CODE TABLE 6 

class SI : public IC, public ID 

{ 

public: 

virtual boolean Qucrylmerfacc (REFIID iid, void **ppv) 
{ return in_punkOutcr->QucryInicrfacc(ii<J, ppv);} 

virtual void AddRefQ 

{ m_punkOutcr-> AddRefQ;} 

virtual void Rcleasc() 

{ mj)unkOuter-> AddRefQ;} 

// implcmetation of IC and ID 

private: 

class lUknownSl : public lUnknown 

{ 

public: 

lUnknownSl (SI *pSI) 
{ m^pSl = pSl; 
m_rcf count = 0;} 

virtual boolean Qucrylmerfacc (REFIID iid, void **ppv) 

{ret = TRUE; 

switch (iid) 

{case IID^IUnknown: 

•ppv « this; 

AddRefQ; 

break; 
case IID C: 

•ppv - (IC •)m_pSl; 

m_pSl->m_pun1cOulcr-> AddRefQ; 

break; 
case IID D: 

•ppv = (ID •)m>SI; 

m_pSl->m_punkOuicr-> AddRefQ; 

break; 

default: 

ret « FALSE; 

}; 
} 

virtual void AddRefQ (m_rcfcount + +;} 
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viriual void RcicascQ {if (--m_rcfcouni = = 0) delete m pSl;} 

private: 

int m^refcount; 
Si m pSl; 

} 

friend lUnknownSl; 

lUnknownS 1 m_I U kn ownS 1 ; 

public 

static void Creatclnstancc (lUnknown *punkOuicr, lUnknown '•*ppimk) 
{ SI "pSl = newSl(punkOuier); 

pSl->OueryIntcrfacc(IID_Unknown, ppunk); 

} 

private: 

void 51 (lUnknown •punkOutcr) : m lUnknownSl(this) 
{ if (punkOulcr = = NULL) 

mjunkOutcr - &m lUnknownSl; 

else 

m_punkOuter = punkOutcr; 



lUnknown m__punkOulcr; 



30 Although the present invention has been described in ternns of a preferred embodiment, it is not 
intended that the invention be limited to his embodiment. Modifications within the spirit of the Invention will 
be apparent to those skilled in the art. The scope of the present invention is defined by the claims which 
follow. 

35 Claims 

1. A method in a computer system of aggregating an enclosed object within an enclosing object, the 
enclosed object having an object management interface and an external interface, the enclosing object 
having a controlling object management interface, each interface having a query function member for 

40 receiving an identifier of an interface and for returning a reference to the identified interface, the 

method comprising the steps of: 

creating an instance of the enclosing object, wherein the query function member of the controlling 
object management interface of the enclosing object receives an identifier of the external interface of 
the enclosed object and returns a reference to the external interface; and 

45 creating an instance of the enclosed object, wherein the query function member of the external 

interface of the enclosed object receives an identifier of an interface, invokes the query function 
member of the controlling object management interface of the enclosing object passing the received 
identifier, and returns a reference retumed by the invoked query function member, of the controlling 
object management interface of the enclosing object as a reference to the identified interface 

50 

2. The method of claim 1 wherein the enclosed object is an aggregate object. 

3. The method of claim 1 wherein the aggregate object is not an aggregatable object. 

55 4. The method of claim 1 wherein the query function member of the controlling object management 
interface of the enclosing object has no specific knowledge of the external interfaces of the enclosed 
object. 
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8. 



The method of claim 1 wherein the query function member of the controlling object management 
interface of the enclosing object has specific knowledge of an external interface of the enclosed object. 

The method of claim 1 wherein the query function member of the controlling object management 
interface of the enclosing object invokes the query function member of the object management 
interface of the enclosed object to retrieve a reference to an external interface of the enclosed object. 

The method of claim 1 wherein the enclosing object stores a reference to the external interface of the 
enclosed object and wherein the query function member of the controlling object management interface 
of the enclosing object returns the stored reference as the reference to the external interface of the 
enclosed object. 

A method in a computer system of implementing a class defining an aggregatable object, the class 
having an object management interface and an external interface, the object management interface and 
external interface having a query function member for providing access to the interfaces, the method 
comprising the steps of: 

generating a create Instance function member for instantiating an- object of the class, wherein the 
create instance function member stores in a data member of the class a reference to the object 
management interface of the class when the object is not aggregated and stores in the data member of 
the class a reference to the controlling object management interface of an enclosing object when the 
object is aggregated; 

generating a query function member of the object management interface, the query function 
member for receiving an identifier of an interface of the object and returning a reference to the 
identified interfar^ft- and 



generating a query function member of the external interface, the query function member for 
receiving an identifier of an interface, invoking the query function member of the object management 
mterface referenced by the data member passing the identifier of the interface, and returning a 
reference returned by the invoked query function member. 

9. The method of claim 5. including the step of generating a global create instance function for 
mstantiating an object of the class, wherein the global create instance function invokes the create 
instance function member to create an instance of the class and invokes the query function member of 
the object management interface to retrieve a reference to an external interface of the class whereby 
the global create instance function is invokable by a client to create an instance of the class without the 
client needing access to the class definition of the class. 

10. A method in a computer system of creating an aggregate object, the aggregate object having an 
enclosed object, the enclosed object having an external interface that is exposed by the aggregate 
object, the method comprising the steps of: 

instantiating the aggregate object, the aggregate object having a query function member for 
retrieving references to interfaces exposed by the aggregate object: 

instantiating the enclosed object, the enclosed object having a query function member of the 
external interface for retrieving references to interfaces exposed by the aggregate object; 

storing a reference to the enclosed object, wherein the query function member of the aggregate 
object uses the stored reference to the enclosed object to retrieve a reference to the exposed external 
interface; and 

storing a reference to the aggregate object, wherein the query function member of the external 
interface uses the stored reference to the aggregate object to retrieve a reference to an interface 
exposed by the aggregate object, 

11. The method of claim 10 wherein the stored reference to the enclosed object is a reference to an object 
management interface of the enclosed object having a query function member and the query function 
member of the aggregate object" invokes the query function member of the referenced object 
management interface to retrieve a reference to the exposed external interface. 

12. The method of claim 10 wherein the stored reference to the enclosed object Is a reference to the 
external interface of the enclosed object and wherein the query function member of the aggregate 
object uses the references to the external interface as the reference to the exposed external interface. 
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13. The method of claim 10 wherein the query function member of the external interface uses the stored 
reference to the aggregate object to invoke the query function member of the aggregate object to 
retrieve a reference to an Interface exposed by the aggregate object. 
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The method of claim 13 wherein the stored reference to the enclosed object is a reference to an object 
management interface of the enclosed object having a query function member and wherein the query 
function member of the aggregate object invokes the query function member of the reference object 
management interface to retrieve a reference to an exposed external interface. 

70 15. The method of claim 10 wherein the external interface provides add reference and release reference 
counting function members and the aggregate object provides add reference and release reference 
counting functions and wherein the reference counting function members of the external interface of the 
enclosed object invoke the reference counting function members of the aggregate object. 

75 16. A method in a computer system of enclosing an enclosed object within an enclosing object the 
enclosing object having an query function member, the enclosed object having an query function 
member, the query function members for retrieving references to interfaces exposed by the enclosing 
object, the enclosed object having an external interface that is exposed by the enclosing object, the 
method comprising the steps of: 

20 instantiating the enclosing object; 

instantiating the enclosed object: 

storing a reference to the enclosed object within the enclosing object: and 

when executing the query function member of the enclosing object, invoking the query function 
member of the enclosed object to retrieve a reference to an exposed extemal interface of the enclosed 
25 Object using the stored reference to the enclosed object. 

17. The method of claim 16. including the step of maintaining a reference count within the enclosing object 
that reflects a number of references to exposed interfaces of the enclosing object. 

30 18. A method in a computer system of enclosing an enclosed object within an enclosing object the 
enclosing object having an query function member, the enclosed object having an query function 
member, the query function members for retrieving references to interfaces exposed by the enclosing 
object, the enclosed object having an external interface that is exposed by the enclosing object the 
method comprising the steps of: 

35 instantiating the enclosing object: 

instantiating the enclosed object; 

storing a reference to the enclosing object within the enclosed object; and 

when executing the query function member of the enclosed object, invoking the query function 
member of the enclosing object to retrieve a reference to an exposed interface of the enclosing object 
40 using the stored reference to the enclosing object. 

19. The method of claim 18. including the step of maintaining a reference count within the enclosing object 
that reflects a number of references to exposed interfaces of the enclosing object. 

45 20. The method of claim 18 wherein the query function member of the enclosed object is associated with 
the external interface of the enclosed object and the enclosed object has an object management 
interface with a query function member and wherein the query function member of the enclosing object - 
invokes the query function member of the object management interface of the enclosed object to 
retrieve a reference to an external interface of the enclosed object. 
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21. A method in a computer system of reference counting for an aggregate object, the aggregate object 
having an enclosing object and an enclosed object, the enclosing object having a reference count the 
enclosing object having an add reference and a release reference function member, the enclosed 
object having an add reference and a release reference function member, the method comprisinq the 
55 steps of: 

under control of the add reference function member of the enclosed object, invoking ttie add 
reference function member of the enclosing object, wherein the add reference function member of the 
enclosing object increments the reference count; and 
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under control of the release reference function member of the enclosed object, invoking the release 
reference function member of the enclosing object, wherein the release reference function member of 
the enclosing object decrements the reference count. 

22. The method of claim 21 wherein when the reference count indicates that no references to the 
aggregate object exists, deleting the enclosing and enclosed objects. 
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A method in a computer system of implementing a class defining an aggregatable object, the class 
having an object management interface and an external interface, the object management interface and 
the external interface having query function members for providing access to the interfaces of the 
aggregatable object, the method comprising the steps of: 
defining the external interface; 

defining the aggregatable class, the aggregatable class inheriting the defined externa! interface as a 
base class, the aggregatable class having an implementation of the query function member of the 
75 defined extemal interface, wherein the query function member of the defined external interface invokes 

the query function member of the object management interface when the object is not aggregated and 
invokes a query function member of an aggregating object when the aggregatable object is aggregated. 

24. An aggregatable object in a computer system comprising: 
20 an object management interface, the object management interface having a query function member 

for receiving an identifier of an interface of the object and returning a reference to the interface: 

an external interface, the external interface having a query function member for receiving an 
Identifier of an interface, invoking the query function member of the object management interface when 
the object is not aggregated and invoking a query function member of an enclosing object when the 
25 object IS aggregated, and returning a reference to the identified interface. 
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@ A method and system for aggregating objects 
within a computer system are provided. In a pre- 
ferred embodiment, the method aggregates an en- 
closed object within an enclosing object. The en- 
closed object has an object management interface 
and an external interface, while the enclosing object 
has a controlling object management interface. Each 
interface exposed to a client by the aggregate object 
has a query function member for receiving an iden- 
tifier of an interface and for returning a reference to 
the identified interface. A preferred method creates 
an instance of the enclosing object. The query func- 
tion member of the controlling object management 
interface of the enclosing object receives an iden- 
tifier of an interface exposed by the enclosing object 
and returns a reference to the exposed interface. A 
preferred method also creates an instance of the 
enclosed object. The query function member of the 
external interface of the enclosed object receives an 
identifier of an interface, invokes the query function 
member of the controlling object management inter- 



face of the enclosing object, passing the received 
identifier, and returns the reference returned by the 
invoked query function member of the controlling 
object management interface of the enclosing object 
as a reference to the identified interface. 
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